Image Display Registry entry

Specify an image (and sound and hint if required) to display along with Summary Data in a module window.

Note: Details about Image Displays can be found here.

Usage

This Registry entry can be assigned to users and groups:

Key User User Group Group Group Group
Key 1 User User Group Group Group Group
Key 2 user user group group Default Default
Key 3 Table Table Table Table Table Table
Key 4 table Default table Default table Default
Key 5 Image Display
Key 6 column
Key 7 value
Value image[;sound[;hint]]
User user Table table Image Display column value image[;sound[;hint]]
User user Table Default Image Display column value image[;sound[;hint]]
Group group Table table Image Display column value image[;sound[;hint]]
Group group Table Default Image Display column value image[;sound[;hint]]
Group Default Table table Image Display column value image[;sound[;hint]]
Group Default Table Default Image Display column value image[;sound[;hint]]

It is also possible to test for the existence of data in a field rather than for an exact value using the following variations:

Group Default Table table Image Display column value image[;sound[;hint]]
Group Default Table Default Image Display column value image[;sound[;hint]]

where:

column

is the name of the column to check for value. If value is found in column (or is one of the values in a table), the rest of the Registry entry is evaluated.

value

is the value to search for in column. If value is found in column (or is one of the values in a table), the rest of the Registry entry is evaluated.

image

is the name of the image file to display. The file must be located on the Vitalware server in the ~Vitalware/client/etc/images directory. The image file is cached on the client as required. The image may be any file type supported by the Vitalware Multimedia Repository (e.g. bmp, png, gif, tiff, tga, pcx, pcd, jpeg, dcx).

When retrieving an image file from the server, Vitalware will first try to retrieve a resolution specific image (21x21 or 42x42). If this image is not found, the specified image file is retrieved. The resolution specific image makes it possible to have two images per image display entry, one shown with Thumbnails disabled and the other shown with Thumbnails enabled.

If Thumbnails (View>Thumbnails) is disabled, the file image21x21.ext is first tried, then image.ext. For example, the Registry entry:

Group Default Table eparties Image Display SecRecordStatus Retired retired.jpg;retired.wav

will result in Vitalware first trying to retrieve retired21x21.jpg; if this file is not found in ~Vitalware/client/etc/images, then retired.jpg would be fetched.

If Thumbnails is enabled and the above Registry entry used, Vitalware would first try to retrieve retired42x42.jpg; if this file is not found in ~Vitalware/client/etc/images, then retired.jpg would be shown.

sound

is optional. The sound will be played after the image is displayed. The sound file must be located on the Vitalware server in the ~Vitalware/client/etc/images directory. The sound file must be in .wav format.

hint

is optional. The hint is shown when the mouse cursor hovers over the displayed image. The hint message is multilingual, with the text for the prompt language being used.

NULL

will match an empty column.

NOT NULL

will match a column with data.

Note: It is possible to display multiple images. If the same image would be displayed more than once, only the first instance is shown. Hence it is possible to display just one image display where multiple values are matched. Also the same named sound file will only be played once. See last example below for details.

Example 1

In this example if a record is accessed in which Status is set to Retired, a warning image is displayed and sound played:

Key Setting Description
Key 1 Group  
Key 2 Default  
Key 3 Table  
Key 4 eparties  
Key 5 Image Display  
Key 6 SecRecordStatus The SecRecordStatus field is searched for the value (Retired) and if found, the image will be displayed and the sound played.
Key 7 Retired

Value

 retired.jpg;retired.wav These files must be stored on the Vitalware server in the ~vitalware/client/etc/images directory.

Example 2

In this example a warning image is displayed and a sound played when a record is accessed where there is any value in the Record Status field:

Key Setting
Key 1 Group
Key 2 Default
Key 3 Table
Key 4 eparties
Key 5 Image Display
Key 6 SecRecordStatus
Key 7 NOT NULL
Value status.jpg;status.wav

Example 3: Bi-lingual hint

If the column SecRecordStatus contains the word Retired, the image is shown with a hint. The following Registry entry may be used:

Key Setting Description
Key 1 Group  
Key 2 Default  
Key 3 Table  
Key 4 eparties  
Key 5 Image Display  
Key 6 SecRecordStatus  
Key 7 Retired  
Value Retired.gif;;Retired;:;Retraité The correct hint, Retired (English) or Retraité (French) will be displayed depending on the prompt language selected by the user.